package org.dromara.exam.service;

import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.exam.domain.bo.ExamTagBo;
import org.dromara.exam.domain.vo.ExamTagVo;
import org.dromara.exam.enums.TagTypeEnum;
import org.springframework.transaction.annotation.Transactional;

import java.util.Collection;
import java.util.List;

/**
 * 标签类型Service接口
 *
 * @author xiyin321
 * @date 2024-04-17
 */
public interface IExamTagService {

    /**
     * 查询标签
     */
    ExamTagVo queryById(Long tagId);

    /**
     * 查询标签分页列表
     */
    TableDataInfo<ExamTagVo> queryPageList(ExamTagBo bo, PageQuery pageQuery);

    /**
     * 查询标签列表
     */
    List<ExamTagVo> queryList(ExamTagBo bo);

    /**
     * 新增标签类型
     */
    Boolean insertByBo(ExamTagBo bo);

    /**
     * 修改标签类型
     */
    Boolean updateByBo(ExamTagBo bo);

    /**
     * 校验并批量删除标签类型信息
     */
    Boolean deleteWithValidByIds(Collection<Long> relIds, Boolean isValid);

    /*
     * 校验标签是否存在
     * */
    Boolean checkTagTypeUnique(TagTypeEnum tagType, String tagName);

    /**
     * 批量处理标签
     *
     * @param relId    关联ID
     * @param tagType  标签类型
     * @param tagNames 标签名称集合
     */
    @Transactional
    void processTags(Long relId, TagTypeEnum tagType, String[] tagNames);

    /**
     * 将标签名称集合转换为标签ID集合
     * @param tagNames 标签名称集合
     * @return 标签ID集合
     */
    List<Long> convertTagsToIds(String[] tagNames);
}
